Riesgos Laborales
🔄 Diagramas de procesos
Esta sección describe la arquitectura de integración asociada a la API cs-arl-xapi, ilustrando el flujo de comunicación entre los sistemas consumidores, la capa de integración en MuleSoft y los sistemas core de Colmena.
📊 Diagrama de Arquitectura
El siguiente diagrama representa el flujo de alto nivel para las operaciones de consulta, creación y retiro de trabajadores, así como los mecanismos de validación, auditoría y comunicación con sistemas core.
🔄 Flujo General
Empresas (Sistemas Consumidores)Inician solicitudes para:
- Consultar trabajadores
- Crear trabajadores dependientes
- Retirar trabajadores del sistema ARL
Capa de Integración – MuleSoft (Endpoint Colmena)La API cs-arl-xapi actúa como punto de entrada, encargándose de:
- Validar identidad del consumidor (
client_id) - Validar contrato y datos del trabajador
- Orquestar la comunicación con los sistemas internos
- Gestionar respuestas estandarizadas
- Validar identidad del consumidor (
Portal Client API AuditSe utiliza para:
- Registrar eventos de auditoría
- Generar trazabilidad de las operaciones
- Asociar las transacciones con el consumidor y el contrato
Portal de ClientesAlmacena y permite la consulta de información relacionada con las operaciones realizadas y su auditoría.
Sistemas Core ColmenaProcesan las novedades de:
- Ingreso de trabajadores
- Retiro de trabajadoresRetornando el resultado de la operación a través de la capa de integración.
Respuesta al ConsumidorLa API retorna al sistema consumidor:
- El resultado de la operación
- Un hash de trazabilidad, que permite identificar la transacción registrada.
🔐 Gestión de Seguridad y Trazabilidad
El diagrama incorpora mecanismos de seguridad y auditoría:
- 🔑 Autenticación OAuth 2.0Las solicitudes son autenticadas mediante token Bearer generado a partir de
client_idyclient_secret. - 🆔 Client ID EnforcementControla el acceso a los recursos expuestos por la API.
- 🧾 Auditoría de OperacionesCada operación registra:
- Usuario
- Contrato
- Tipo de operación
- Fecha de ejecución
- Resultado
- 🔐 Hash de RespuestaSe genera un hash (SHA-256) que consolida información relevante de la transacción, permitiendo:
- Integridad de la información
- Seguimiento y conciliación
- Trazabilidad de auditoría
🧮 Estructura de Hash y Respuesta
| Campo | Descripción |
|---|---|
| Hash | SHA-256 generado a partir de token, contrato, usuario y operación |
| Response | Respuesta en formato JSON |
| Date | Fecha y hora de la novedad procesada |
📝 Nota
A medida que se incorporen nuevos flujos o integraciones, podrán añadirse diagramas adicionales a esta sección (por ejemplo: diagramas de secuencia o diagramas por dominio funcional).
📞 Soporte
Para asistencia técnica, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.
📅 Información Adicional
Documentación creada y actualizada en Enero 2026 por epalma@fgs.co - Edna Nayibe Palma
© 2026 Fundación Grupo Social - Colmena. Archivo generado para la API cs-arl-xapi
📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente y cambios en tiempo real, consulta siempre el Portal de Exchange oficial.
🔒 Aviso de Seguridad: Nunca compartas credenciales de API en repositorios públicos o documentación. Usa siempre variables de entorno para información sensible y rota tokens regularmente.